home *** CD-ROM | disk | FTP | other *** search
/ Monster Media 1994 #2 / Monster Media No. 2 (Monster Media)(1994).ISO / clipper / bropls.zip / BROGUIDE.TXT < prev    next >
Text File  |  1994-06-13  |  36KB  |  762 lines
  1.  
  2.                                Guide to BroPlus
  3.                                ----------------
  4. What is BroPlus:
  5.  
  6.         BroPlus is a database browse utility exploiting the advanced features
  7.         of Clipper 5's TBrowse object to easily set up views into Clipper
  8.         and dBase databases. A total DBU replacement, it allows for multiple
  9.         select areas and is network ready. Its many options can be explored
  10.         from Pulldown menus. Hot-keys are available for quick access to most
  11.         options. Built-in support for CA-Clipper 5.2 RDDs and 3rd-party RDDs
  12.         including FlexFile data access is provided.
  13.  
  14. Possible uses for BroPlus:
  15.  
  16.         - Developers, consultants:
  17.  
  18.           Quick access to databases during application development and
  19.           testing. Verify/Modify/Print content and structure of
  20.           database/index files on the fly.
  21.  
  22.           Use as an analytical tool while getting familiar with an already
  23.           implemented database application system.
  24.  
  25.           Housekeeping tasks not provided in a custom database application,
  26.           like recreation of index files, verifying database content after
  27.           a system crash, verifying index file integrity, ad hoc creation
  28.           of database listings, etc.
  29.  
  30.           Setting up of highly customized views into a clients databases
  31.           in minutes, without programming. Those views can easily be made
  32.           available to the end user from an application program's menu.
  33.  
  34.           The Runtime module included with BroPlus allows for creation of
  35.           royalty free Runtime versions of BroPlus to be installed at
  36.           client's sites. A Runtime version can be a stand-alone program
  37.           or can be linked into another Clipper application. View files
  38.           created by the developer can be restored by a Runtime module
  39.           and made available to the end user.
  40.  
  41.         - End users:
  42.  
  43.           Because of its menu driven interface, BroPlus is easily accessible
  44.           to end users. Adequate protection is provided to guarantee
  45.           database system integrity and prevent end users from modifying
  46.           data without authorization.
  47.           A basic knowledge of dBase is required to fully exploit the more
  48.           advanced options of BroPlus, like ability to specify valid
  49.           expression syntax.
  50.  
  51.  
  52. Environment:
  53.  
  54.         BroPlus is simply an executable file, BRO.EXE. Load it onto your
  55.         harddisk, and put the directory where it is located in the PATH
  56.         statement of your AUTOEXEC.BAT.
  57.  
  58.         BroPlus checks for the presence of an environment variable "BRO"
  59.         If you add the statement SET BRO=<path name> to your AUTOEXEC,
  60.         BroPlus will look for a Global Settings file "BRO.INI" in the
  61.         directory specified by <path name>, and reinstate these Global
  62.         Settings at startup. To save your Global Settings to the file,
  63.         press F6 from any Browse screen and select "Save Global Settings".
  64.  
  65.         The environment variable can also contain a key word which, when
  66.         present, will allow the user to have "Modify" enabled. If the key
  67.         word is NOT present in the env. var., the program will always start
  68.         with "Modify disabled", and the key word must be entered from the
  69.         Global Settings menu option "Modify enabled/disabled" each time the
  70.         program is run if "Modify" is to be enabled.
  71.                 This is a protective measure to prevent unauthorized access
  72.         to the data modification options of BroPlus.
  73.  
  74.         The complete environment variable:
  75.  
  76.                 SET BRO=<path name> /<keyword>
  77.  
  78.         <keyword> is confidential and will be given out to qualified users
  79.         only.
  80.  
  81. Command line:
  82.  
  83.         Running BRO without command line parameters will get you right into
  84.         the database selection screen of databases in the current directory.
  85.  
  86.         BRO <database name> [ <indexfile name> ] puts you right into Browse
  87.         mode for the specified database [with the specified index file open].
  88.         Both <database name> and <indexfile name> can include a path.
  89.  
  90.         BRO /v   will provide you with a picklist of previously saved
  91.         view files in the Default View Directory.
  92.  
  93.         BRO /v <viewfile name>  will restore the under <viewfile name> saved
  94.         Browse screen(s) and put you right into Browse mode.
  95.  
  96.         BRO [ options ] /<rddname>  will overwrite the in the Global
  97.         Settings file specified database driver and force usage of the
  98.         specified <rddname> as database driver.
  99.  
  100.         BRO [ options ] /m    will set up BroPlus for monochrome monitors.
  101.  
  102. Online Help:
  103.  
  104.         BroPlus provides context sensitive Help from everywhere by simply
  105.         pressing <F1>. Help is also available by picking a topic from an
  106.         index of Help topics.
  107.         Load the files BROPLUS1.HLP, BROPLUS2.HLP & BROPLUS3.HLP into the
  108.         same directory as the executable file BRO.EXE to access the Help
  109.         information from any other directory.
  110.  
  111. Display mode:
  112.  
  113.         BroPlus's standard Display Mode is Browse Mode. All Main menu options
  114.         are accessible from Browse mode through function keys F1 - F9.
  115.         While on the Main Menu bar, using the right/left arrow keys lets you
  116.         move through all Main Menu options. Pressing <Esc> from the Main Menu
  117.         options brings you back to Browse mode.
  118.  
  119. Main Menu options:
  120.  
  121.         <F1> Help Options
  122.  
  123.         <F2> Database Options
  124.  
  125.         <F3> Index Options
  126.  
  127.         <F4> Fields Options
  128.  
  129.         <F5> AreaSet: Options to allow Customization of View
  130.  
  131.         <F6> GlobalSet: Options to configure BroPlus
  132.  
  133.         <F7> Record: Options pertaining to Database Records
  134.  
  135.         <F8> Command: Clipper/dBase Commands operating on Databases
  136.  
  137.         <F9> Exit
  138.  
  139.  
  140. <F1> Help Options:
  141.  
  142.         - Browse Window Help
  143.         - Help on Help
  144.         - Help Index: Picklist of Help topics
  145.         - Command Line Parameters
  146.         - Expression Evaluator, Hot-key: <Alt-F1>
  147.         - Calculator,           Hot-key: <Ctrl-F1>
  148.         - Copyright
  149.  
  150.  
  151. <F2> Database Options:
  152.  
  153.         - Database Selection Screen
  154.         - Advance to Next / Previous Database
  155.         - Close Database
  156.         - Toggle Open Mode: Exclusive or shared
  157.         - Alias Name
  158.         - Create/Modify Structure
  159.         - Database FileSpec for Selection Screen
  160.         - Change Directory
  161.         - Shell to DOS
  162.  
  163.  
  164. <F3> Index Options:
  165.  
  166.         - Index File Selection Screen
  167.         - Advance to Next / Previous Index
  168.         - Tag Selection/Information
  169.         - Index ScopeTop/Bottom
  170.         - Dynamic Index Options: Toggle Asc/Desc, Unique/Non-Unique, Custom
  171.         - Toggle Open Mode: Exclusive or shared
  172.         - Create Index File
  173.         - Verify Index File Integrity
  174.         - Toggle Index PreSelection
  175.         - Index FileSpec for Selection Screen
  176.         - Change Directory
  177.         - Shell to DOS
  178.  
  179.  
  180. <F4> Fields Options:
  181.  
  182.         - Field/Expression Selection Screen
  183.         - Cut/Delete Column
  184.         - Paste Column
  185.         - Insert Column
  186.         - Lock # of Fields (Freeze)
  187.         - Column Options: Heading, Width, Picture, GET WHEN, GET VALID
  188.         - Create/Modify Structure
  189.         - Toggle FlexFile Pointer Field
  190.  
  191.  
  192. <F5> AreaSet Options:
  193.  
  194.         Filter/Range:  Enter a Conditional Expression
  195.                        and/or a Low Range / High Range Pair of Values
  196.                        to limit your Browse Screen to a Subset of Data.
  197.                        Hot Key: <Alt-F>
  198.                 Note:  An Index must be in Control to allow Entry of a Range.
  199.                        Condition and Range are regarded as ONE Setting.
  200.                        Changing the Index Order will remove BOTH Condition
  201.                        AND Range
  202.  
  203.         Relation:      Specify Relations between currently open Databases.
  204.                        At least two Databases must be open to allow
  205.                        Setting of a Relation
  206.                        Hot Key: <Alt-R>
  207.  
  208.         Color Condition: Specify a Condition based on the Value of a Database
  209.                        Field. All Browse Rows containing Values meeting the
  210.                        Condition will be displayed in a different Color than
  211.                        the Standard Browse Color.
  212.                        Hot Key: <Alt-C>
  213.  
  214.         Incremental Seek: Toggle the ability to AutoSeek ( Seek while you
  215.                        type ) while in Browse Mode with a Character Key
  216.                        Index File open.
  217.                        While in Incremental Seek Mode, Use the <BackSpace>
  218.                        Key for "Decremental" Seek, <Ctrl-BackSpace> to
  219.                        clear the Incremental Seek String.
  220.                        Hot Key: <Alt-I>
  221.  
  222.         Memo Width:    For each Select Area, the Memo Display Width can be
  223.                        specified, to be able to adjust the View to a preset
  224.                        Memo Width, and to allow proper Printing of
  225.                        Memo Fields and Flexfile Memos.
  226.                        (see Commands, <F8>, "List to Print").
  227.  
  228.         Memo Pack:     If the SIX driver is linked, this option allows
  229.                        packing of the FPT or SMT file with a customizable
  230.                        Memo Block size.
  231.  
  232.         FlexFile Link: Specify the name of a FlexFile to be linked to the
  233.                        current database (FlexFile API interface).
  234.  
  235.         RYO Index Link: Specify "Roll Your Own" Index to be used for Adding/
  236.                        Dropping of individual Keys (SIx & Comix driver only).
  237.  
  238.         Next Select Area: Rotate to the Browse Screen for the "Next" Select
  239.                        Area.
  240.                        Hot Key: <Alt-N>
  241.  
  242.         Previous Select Area: Rotate to the Browse Screen for the "Previous"
  243.                        Select Area.
  244.                        Hot Key: <Alt-Minus>
  245.  
  246.                        Note: While in Browse Mode, the Hot Keys <Alt-1> to
  247.                        <Alt-7> are also available to directly access the
  248.                        Database Browses for Areas 1 through 7, without
  249.                        having to skip (with <Alt-N>) through each Browse
  250.                        "between" the current Browse Screen and the
  251.                        Target Browse Screen.
  252.  
  253.         Next Index Order: Remain in the current Browse Screen, but make the
  254.                        "Next" Index in the List of Selected Index Files
  255.                        the Controlling Index.
  256.                        The current Record will remain highlighted, but
  257.                        the Browse Screen will refresh above and below the
  258.                        Highlight, reflecting the new Index Order.
  259.                        This allows also to set the Order to 0
  260.                        (record number order) while keeping all Index Files
  261.                        open.
  262.                        Hot Key: <Alt-O>
  263.  
  264.                 Note:  Any Filter/Range Settings will be removed when
  265.                        switching the Controlling Index.
  266.  
  267.         Next / Previous Window: If the Split screen option is selected,
  268.                        move between windows using the <Tab> or <Shift-Tab>
  269.                        keys.
  270.  
  271.         Save Current View: Save all currently defined Browse Screens
  272.                        including Filter/Range, Relations, Color Condition,
  273.                        Lock, Column Options, Memo Width, Flexfile Link,
  274.                        RYO Index Link, Index Order, Selected Database,
  275.                        to a View File named by you.
  276.                        Hot Key: <Alt-W>
  277.  
  278.         Restore View:  Restore a View from a previously saved View File
  279.                        Hot Key: <Alt-V>
  280.  
  281.         Current View Info: Document your data environment with a single
  282.                        keystroke! Output, to printer or to file, all table,
  283.                        index, range, filter, scope, relation information,
  284.                        for all work areas.
  285.  
  286.  
  287. <F6> GlobalSet Options:
  288.  
  289.         Database Driver:           Select from among the available Database
  290.                                    Drivers. Any Database opened after the
  291.                                    selection will be using the New Database
  292.                                    Driver (and maintain it until closed).
  293.  
  294.                                    BroPlus for Clipper 5.01a: Available RDDs
  295.                                    are: DBFNTX, DBFNDX, SIXCDX.
  296.  
  297.                                    BroPlus for Clipper 5.2: Available RDDs
  298.                                    are: DBFNTX, DBFNDX, DBFMDX, DBFCDX,
  299.                                    COMIX 1 & 3, DBFNSX (HiPerSIx), SIx Driver
  300.                                    (SIXCDX, SIXNSX, SIXNTX flavors).
  301.  
  302.         Default Extension:         Specify the Default Extensions to be used
  303.                                    for Database & Index file names. In Data-
  304.                                    base & Index Picklists and Dbf / Index
  305.                                    Name entry fields, these extensions are
  306.                                    assumed if no extension is explicitely
  307.                                    specified.
  308.                                    For SIx Driver and FlexFile memo files,
  309.                                    extensions other than the default FPT, SMT
  310.                                    and DBV extensions can also be specified.
  311.  
  312.         Default Open Mode:         Toggle whether databases should initially
  313.                                    be opened in SHARED or EXCLUSIVE Mode.
  314.                              Note: EXCLUSIVE Mode should ONLY be selected on
  315.                                    Standalone Computers, NEVER on Network
  316.                                    Workstations. To toggle to EXCLUSIVE Mode
  317.                                    "Modify" must be enabled (see below).
  318.  
  319.         Enable/Disable Modify:     Toggle Ability to Modify Data.
  320.                                    If Disabled: Only Browsing/Viewing of Data
  321.                                    is accessible.
  322.                                    If Enabled: All of BroPlus's features are
  323.                                    accessible.
  324.                                    If the <keyword> is NOT present in the
  325.                                    Environment Variable BRO, it must be
  326.                                    entered as Password if you try to toggle
  327.                                    "enable" on. (Except for DEMO version)
  328.  
  329.         Protected/Immediate Edit:  Request <Enter> Key for Editing, or type
  330.                                    immediately into Database Fields
  331.  
  332.         Cell/Row/Column Edit:      After Saving Edited Field Data with
  333.                                    <Enter>: Stay on current Cell, proceed
  334.                                    to next Field/same Record, or proceed
  335.                                    to same Field/next Record
  336.  
  337.         Show/Hide Deleted Records: Toggle SET DELETED On/Off
  338.                                    Hot Key: <Alt-D>
  339.  
  340.         Softseek On/Off:           Toggle Softseek
  341.                                    Hot Key: <Alt-Q>
  342.  
  343.         Preselect Indexes:         ON:  Only Index Files with matching
  344.                                         Index Key Expressions are presented
  345.                                         for Selection
  346.                                    OFF: All Index Files in the current
  347.                                         Directory are presented for Selection
  348.                                    Hot Key: <Alt-P>
  349.  
  350.         Sound On/Off:              Turn sound signaling on or off.
  351.  
  352.         Default View Directory:    Specify a Default Directory where all View
  353.                                    Files will be saved to / restored from
  354.                                    ( Allows for a "Personal" View File
  355.                                      Directory on the local Hard Drive,
  356.                                      an "official" View File Directory on the
  357.                                      Network Drive etc. )
  358.  
  359.         Screen Mode:               Toggle between 25 Line / 43 Line / 50 Line
  360.                                    Screen Mode.
  361.                                    Hot Key: <F10>
  362.  
  363.         Split Screen / Zoom:       Toggle between Split screen and Full
  364.                                    screen Browse windows.
  365.                                    Hot Key: <Shift-F10>
  366.  
  367.         Move Screen Border:        If Split screen is selected, move the
  368.                                    border between Top- and Bottom window
  369.                                    up or down.
  370.                                    Hot Key: <Ctrl-F10>
  371.  
  372.         Browse Column Buffer Size: Set the number of columns to be used for
  373.                                    TBrowse objects. Default size is 12.
  374.                                    For faster vertical browsing, enter a
  375.                                    smaller number.
  376.  
  377.         Default Memo Width:        Initial Memo Width to be used when opening
  378.                                    a database.
  379.  
  380.         Auto-Alias On/Off:         Specify whether to open a dbf using the
  381.                                    default alias name, or to enter a custom
  382.                                    alias before USEing the dbf.
  383.  
  384.         Epoch:                     Specify the base year of a 100-year period
  385.                                    in which all dates containing only two
  386.                                    year digits are assumed to fall.
  387.  
  388.         Date Format:               Select your country-specific Date Format
  389.                                    from among 14 choices (both with and w/o
  390.                                    the century digits.
  391.  
  392.         Printer Control Codes:     Enter Starting and Ending Printer Control
  393.                                    Codes to be used for printing of database
  394.                                    content and structures.
  395.                                    Use dBase syntax, e.g.:  chr(27)+"(s16H"
  396.  
  397.         Dirty-Read On/Off:         This toggle allows speeding up processing
  398.                                    of shared files on a network if the SIx
  399.                                    driver is in control.
  400.  
  401.         Default Memo Block Size:   Memo Block size to be used when creating
  402.                                    a new table under SIx Driver or Comix 3.
  403.  
  404.         Save Global Settings:      Save current Global Settings to a File
  405.                                    "BRO.INI" in the Directory specified with
  406.                                    the Environment Variable "BRO". At Startup
  407.                                    all saved Global Settings are then
  408.                                    automatically restored.
  409.  
  410.  
  411. <F7> Record:
  412.  
  413.         Note: When a Range and/or Condition is specified, then SEEK, GOTO,
  414.               LOCATE, and SKIP will operate only within the specified Range,
  415.               and display a Message if the Target Record is not within the
  416.               Range / does not meet the Condition.
  417.  
  418.         Seek:                   Seek a Value in an Indexed Database.
  419.                                 Only selectable when an Index is in Control
  420.                                 Hot Key: <Alt-S>
  421.  
  422.         Goto:                   Go to a specified Record Number
  423.                                 Hot Key: <Alt-G>
  424.  
  425.         Locate:                 Locate a Record meeting a specified Condition
  426.                                 Hot Key: <Alt-U>
  427.  
  428.         Skip:                   Skip a specified Number of Records
  429.                                 (forward or backward)
  430.                                 Hot Key: <Alt-J>
  431.  
  432.         Top of Window:          Move the Browse Highlight Bar to the first
  433.                                 Row of the Browse Window
  434.                                 Hot Key: <Alt-T>
  435.  
  436.         Bottom of Window:       Move the Browse Highlight Bar to the last
  437.                                 Row of the Browse Window
  438.                                 Hot Key: <Alt-B>
  439.  
  440.         Record View/Edit:       Provides Full Screen View, ONE record at a
  441.                                 time, of the Fields in the current database.
  442.                                 Options for All and for Selected Fields.
  443.                                 A Bottombar Menu offers options to Edit,
  444.                                 Delete/Recall the record, Append a record,
  445.                                 and move the record pointer from inside this
  446.                                 window.
  447.                                 Hot Key: <Alt-E>
  448.                         Note:   Field Edit is also available by pressing
  449.                                 <Enter> on the current Browse Field,
  450.                                 or (if "Immediate Edit" is ON) by simply
  451.                                 typing into the Field
  452.  
  453.         Append Record:          Provides Full Screen Data Entry to Add a
  454.                                 New Record to the Database
  455.                                 Hot Key: <Ins>
  456.                         Note:   Appending of Records is also available
  457.                                 by going to the Bottom of the Browse
  458.                                 (<Ctrl-PgDn>), pressing the Down Arrow Key,
  459.                                 and Editing the current Field
  460.  
  461.         Delete/Recall Record:   Mark / UnMark the currently highlighted
  462.                                 Browse Record for Deletion
  463.                                 Hot Key: <Del>
  464.  
  465.         Erase Memo:             Erase Memo, or Flexfile data the Flexfile
  466.                                 pointer field under the current Browse cursor
  467.                                 is pointing to.
  468.                                 Hot Key: <Alt-BackSpace>
  469.  
  470.         Copy Field:             Copy current Field or Expression under the
  471.                                 Browse cursor to the Clipboard
  472.                                 Hot Key: <Shift-F4>
  473.  
  474.  
  475.         Paste Field:            Paste last copied item from the Clipboard
  476.                                 into the current Field under the Browse
  477.                                 cursor
  478.                                 Hot Key: <Ctrl-F4>
  479.  
  480.         Copy Record:            Copy current Browse row in the Browse window
  481.                                 to the Clipboard (stored as an array)
  482.                                 Hot Key: <Shift-F7>
  483.  
  484.         Paste Record:           Paste last copied item from the Clipboard
  485.                                 into the current data row under the Browse
  486.                                 cursor
  487.                                 Hot Key: <Ctrl-F7>
  488.  
  489.         View Clipboard:         Display the Clipboard items, to view, edit,
  490.                                 add, delete items, or paste selected items
  491.                                 into the current Field or Data row under the
  492.                                 Browse window cursor.
  493.                                 Hot Key: <Alt-F7>
  494.  
  495.  
  496. <F8> Command:
  497.  
  498.         These Options are mainly Database Commands that do Global Processing
  499.         on the currently selected Database.
  500.  
  501.         Append From:           Append data from another DBF/Text file to
  502.                                the currently selected database, for/while
  503.                                a Condition/Range.
  504.                                Testing is provided to ensure that the
  505.                                Source File is NOT in Use
  506.  
  507.         Copy Structure         Copy the Structure of the currently selected
  508.                                database to another File
  509.  
  510.         Copy Stru Exte         Create an Extended Structure database of the
  511.                                currently selected database.
  512.  
  513.         Copy to                Copy data from the currently selected
  514.                                database to another DBF/Text file,
  515.                                for/while a Condition/Range.
  516.                                Testing is provided to verify if a
  517.                                target file of the specified name already
  518.                                exists, and that it is NOT in use.
  519.  
  520.         Count                  Count the Number of Records for/while
  521.                                a Condition/Range
  522.  
  523.         Delete                 Delete all Records for/while a Condition/Range
  524.  
  525.         Label Form             Execute the Label Form command, specify any
  526.                                optional clauses
  527.  
  528.         List to Print          List the currently selected Field Selection
  529.                                or the Content of a specified Memo Field or
  530.                                Flex Memo to the Printer or to a Text File,
  531.                                for/while a Condition/Range.
  532.  
  533.         Pack                   Pack the currently selected database,
  534.                                recreate all its currently open Index files
  535.  
  536.         Recall                 Recall all Records for/while a Condition/Range
  537.  
  538.         Reindex                Recreate all currently open Index files of
  539.                                the currently selected database
  540.  
  541.         Replace                Replace any Field of the currently selected
  542.                                database with an expression for/while a
  543.                                Condition/Range
  544.  
  545.         Report Form            Execute the Report Form command, specify any
  546.                                optional clauses
  547.  
  548.         Run                    Shell out to DOS
  549.                                Hot Key: <Alt-Z>
  550.  
  551.         Sum/Average            Calculate the Sum and Average for a specified
  552.                                numeric Database Field / Expression, for/while
  553.                                a Condition/Range
  554.  
  555.         Zap                    Zap the currently selected database file,
  556.                                Including all its currently open Index files
  557.  
  558.         Swap to DOS            Execute DOS Programs with almost the same
  559.                                amount of memory available as for BroPlus
  560.                                itself
  561.  
  562. HotKeys:
  563.  
  564.         Next to the Menu Options on the Pulldown Menus, Hot Keys are
  565.         displayed ( <Alt-A>, ..., <Alt-Z>, and others ).
  566.         These Hot Keys can be used to instantly access the Options from
  567.         the Browse Screen without going through the Pulldown Menu System.
  568.  
  569.         Some of the Menu Options are specified solely to educate the User
  570.         towards using the corresponding Hot Keys.
  571.  
  572.  
  573. Special Screens:
  574.  
  575.         Modify Structure:      Select "Create/Modify Structure" from the
  576.                                Database or Fields pull-down menus to display
  577.                                the Structure window, or access it from the
  578.                                Database Selection Screen or Field Selection
  579.                                Screen by pressing <Alt-M>. A Database
  580.                                Structure Browse screen appears. Modify the
  581.                                Structure as you wish, then
  582.  
  583.                 <Alt-E>        Write out this Structure as a new
  584.                                Empty Structure to a Database with a Name
  585.                                of your choosing
  586.  
  587.                 <Alt-M>        Write the Database Content to the modified
  588.                                Structure Database (original File or New File)
  589.                                BroPlus detects if only Field Names were
  590.                                changed, and allows you to change only the
  591.                                Names while preserving all your Data.
  592.  
  593.                 <Alt-P>        Prints current Database Structure to the
  594.                                Printer or to a Text File
  595.  
  596.                 <Alt-X>        Toggle Exclusive / Shared Mode
  597.  
  598.                 <F10>          Toggle between 25 Lines / 43 Lines / 50 Lines
  599.                                Screen Mode (same as in Standard Browse Mode)
  600.  
  601.  
  602.         Set Relation:
  603.  
  604.                 <left,right>   move the lightbar to the Parent, Child, or
  605.                                Expression Column
  606.  
  607.                 <Enter>        Parent Column: Display a Picklist of Databases
  608.                                to select the Parent Database from
  609.  
  610.                                Child Column: Display a Picklist of Databases
  611.                                to select the Child Database from
  612.  
  613.                                Expression Column: Go into Edit Mode to enter
  614.                                the relational expression. Press <F4> while
  615.                                in Edit Mode for a Picklist of Fields from
  616.                                the Parent Database
  617.  
  618.                                Scope in Child Browse Window: Toggle On/Off
  619.  
  620.                 <Del>          Remove currently highlighted Relation
  621.  
  622.                 <Down>         Add another Relation
  623.  
  624.                 <Esc>          Return to Menu / Browse Screen
  625.  
  626.  
  627. <F4> Key for Field Selection:  On all Entry Fields requiring Entry of
  628.                                an Expression based on Fields from the
  629.                                currently selected Database, the <F4> Key
  630.                                pops up a Picklist of Field Names to build
  631.                                the Expression. ( Index Key Expression,
  632.                                Relational Expression, etc. )
  633.  
  634. <Alt-Y> Key for Directory Selection: On all Entry Fields requiring Entry of
  635.                                a Directory or Path, the <Alt-Y> Key allows
  636.                                to pop up a Picklist of all Directories for
  637.                                a specified Drive.
  638.  
  639. FlexFile Access: FlexFile Data Access is fully integrated into BroPlus as
  640.                  long as the .EXE file is linked with the FlexFile library,
  641.                  and supporting OBJ files included with BroPlus.
  642.  
  643.                  FlexFile API interface: The view can be customized to
  644.                  specify a non-default Flexfile name to be linked to a
  645.                  database (F5), and an entire Browse Column may be marked
  646.                  as Flexfile pointer field. (see: <F4> Fields, FlexFile
  647.                  Pointer Field).
  648.  
  649.                  FlexFile RDD interface: If this option is selected during
  650.                  linking, BroPlus "senses" automatically if a database
  651.                  contains FlexFile data stored in standard Memo fields,
  652.                  and no further customization for access is needed.
  653.  
  654.                  FlexFile data can be created, retrieved, viewed, edited,
  655.                  saved, and erased while in the BroPlus interface. Support
  656.                  is provided for data types Character, Clipper muldim
  657.                  arrays, Date, Logical and Numeric. The interface for
  658.                  viewing/editing of Clipper arrays was closely modeled
  659.                  after Clipper 5's debugger, with the added option of
  660.                  interactively expanding / shrinking an array.
  661.  
  662. Customization:
  663.  
  664.           Three different methods are provided to allow the User to build
  665.           Expressions based on her/his own User Defined Functions:
  666.  
  667.           1) Object Modules containing the Code for those Functions can be
  668.              linked into BroPlus.
  669.  
  670.           2) Additional libraries can be linked into BroPlus, and EXTERNAL
  671.              references to functions from those libraries can be embedded
  672.              into BroPlus.
  673.  
  674.           3) Functions can be added in source code form to a special PRG
  675.              called STARTUP.PRG.
  676.  
  677. Runtime Module:
  678.  
  679.           By replacing the main module BRO.OBJ with BRORUN.OBJ in the
  680.           Link scripts provided with this package, a Runtime version of
  681.           BroPlus can be generated.
  682.           The Runtime version of BroPlus differs from the full version of
  683.           BroPlus. With Runtime, the following features are not accessible:
  684.  
  685.             - Database Selection Screen
  686.             - Index Selection Screen
  687.             - Fields Selection Screen
  688.             - Relations Window
  689.             - Save Current View
  690.  
  691.           To access a Browse Screen with Runtime, BroPlus must be passed
  692.           either a database name (with optional index name) or a view
  693.           file name (preceded by "/V") as parameter.
  694.  
  695.              Runtime versions of BroPlus can be distributed royalty-free.
  696.           A Runtime version can be a Standalone program or can be linked
  697.           into another Clipper application.
  698.  
  699.           If BroPlus is invoked as a module from within another program,
  700.           the syntax is:
  701.                         BRO( <options> )
  702.           where <options> are the same options as specified for Command
  703.           Line Parameters.
  704.  
  705.  
  706. License Agreement,
  707. Money Back Guarantee,
  708. Warrantee:                      Read the file "License.txt"
  709.  
  710.  
  711. Final Note: Suggestions regarding enhancements, modifications, and
  712.             performance are encouraged! BroPlus is designed as a tool to
  713.             help you in your daily work. The more feedback you provide us
  714.             with, the better we can understand what your needs are.
  715.  
  716. Credits:    Thanks go to:
  717.             Terry McConnell for his routines to Save/Restore Ragged Arrays
  718.             to/from Disk.
  719.             John Opincar for his routines to verify if a given Index File
  720.             is up to date.
  721.             Rick Spence for many valuable ideas from his "Clipper Program-
  722.             ming Guide", especially his C-function to Change Field Names
  723.             of a Database Structure by simply updating the Database Header.
  724.             Pedro Polakoff III for converting Spence's function to require
  725.             Clipper libraries only.
  726.             Ted Means for his assembly functions to change the drive and
  727.             directory.
  728.             Brent Farmer for his assembly functions to retrieve an array
  729.             of directories from a specified drive.
  730.             Ira Emus for many valuable ideas and suggestions.
  731.             And everybody else from whom I grasped ideas while lurking on
  732.             Nanforum.
  733.  
  734. Trademarks: Clipper is a trademark of Computer Associates, International
  735.             FlexFile is a trademark of Ganahl Software
  736.             Overlay() is a trademark of SDI
  737.             SIx driver is a trademark of Successware 90
  738.             Comix is a trademark of Loadstone, Inc.
  739.  
  740.  
  741. For further Information contact:
  742.  
  743.             USA
  744.  
  745.             Smart Code Programming
  746.             22323-6 Sherman Way, Suite 185
  747.             West Hills, CA 91303
  748.             Phone:    818-710-9323
  749.             Fax:      818-710-9391
  750.             BBS:      818-986-5781
  751.             CompuServe: 73760,1102
  752.  
  753.             Europe
  754.  
  755.             ┌────────────────────────────────────────────────┐
  756.             │ Adress:                    Tel.:+49-40-7661290 │
  757.             │ SOFTSOL GmbH               Fax :+49-40-7665664 │
  758.             │ Neue Str.35a               BBS :+49-40-7665527 │
  759.             │ 21073 Hamburg              CIS : 100112,3401   │
  760.             │ Germany                    Fido: 2:240/5300    │
  761.             └────────────────────────────────────────────────┘
  762.